home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / cgesv.z / cgesv
Encoding:
Text File  |  1998-10-30  |  3.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCGGGGEEEESSSSVVVV((((3333FFFF))))                                                            CCCCGGGGEEEESSSSVVVV((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CGESV - compute the solution to a complex system of linear equations  A *
  10.      X = B,
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE CGESV( N, NRHS, A, LDA, IPIV, B, LDB, INFO )
  14.  
  15.          INTEGER       INFO, LDA, LDB, N, NRHS
  16.  
  17.          INTEGER       IPIV( * )
  18.  
  19.          COMPLEX       A( LDA, * ), B( LDB, * )
  20.  
  21. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  22.      CGESV computes the solution to a complex system of linear equations
  23.         A * X = B, where A is an N-by-N matrix and X and B are N-by-NRHS
  24.      matrices.
  25.  
  26.      The LU decomposition with partial pivoting and row interchanges is used
  27.      to factor A as
  28.         A = P * L * U,
  29.      where P is a permutation matrix, L is unit lower triangular, and U is
  30.      upper triangular.  The factored form of A is then used to solve the
  31.      system of equations A * X = B.
  32.  
  33.  
  34. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  35.      N       (input) INTEGER
  36.              The number of linear equations, i.e., the order of the matrix A.
  37.              N >= 0.
  38.  
  39.      NRHS    (input) INTEGER
  40.              The number of right hand sides, i.e., the number of columns of
  41.              the matrix B.  NRHS >= 0.
  42.  
  43.      A       (input/output) COMPLEX array, dimension (LDA,N)
  44.              On entry, the N-by-N coefficient matrix A.  On exit, the factors
  45.              L and U from the factorization A = P*L*U; the unit diagonal
  46.              elements of L are not stored.
  47.  
  48.      LDA     (input) INTEGER
  49.              The leading dimension of the array A.  LDA >= max(1,N).
  50.  
  51.      IPIV    (output) INTEGER array, dimension (N)
  52.              The pivot indices that define the permutation matrix P; row i of
  53.              the matrix was interchanged with row IPIV(i).
  54.  
  55.      B       (input/output) COMPLEX array, dimension (LDB,NRHS)
  56.              On entry, the N-by-NRHS matrix of right hand side matrix B.  On
  57.              exit, if INFO = 0, the N-by-NRHS solution matrix X.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCGGGGEEEESSSSVVVV((((3333FFFF))))                                                            CCCCGGGGEEEESSSSVVVV((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      LDB     (input) INTEGER
  75.              The leading dimension of the array B.  LDB >= max(1,N).
  76.  
  77.      INFO    (output) INTEGER
  78.              = 0:  successful exit
  79.              < 0:  if INFO = -i, the i-th argument had an illegal value
  80.              > 0:  if INFO = i, U(i,i) is exactly zero.  The factorization has
  81.              been completed, but the factor U is exactly singular, so the
  82.              solution could not be computed.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.